home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| LaTeX document, ASCII text, with CR line terminators
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/281 LaTeX (Subdocument)
| default
| |
| 100%
| detectItEasy
| Format: plain text[CR]
| default (weak)
|
|
| id metadata |
|---|
| key | value |
|---|
| macFileType | [TEXT] |
| macFileCreator | [R*ch] |
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 73 69 67 6e 61 | 6c 7d 7d 0d 0d 5c 62 69 |de{signa|l}}..\bi|
|00000030| 6d 6f 64 69 6e 64 65 78 | 7b 73 69 67 6e 61 6c 7d |modindex|{signal}|
|00000040| 0d 54 68 69 73 20 6d 6f | 64 75 6c 65 20 70 72 6f |.This mo|dule pro|
|00000050| 76 69 64 65 73 20 6d 65 | 63 68 61 6e 69 73 6d 73 |vides me|chanisms|
|00000060| 20 74 6f 20 75 73 65 20 | 73 69 67 6e 61 6c 20 68 | to use |signal h|
|00000070| 61 6e 64 6c 65 72 73 20 | 69 6e 20 50 79 74 68 6f |andlers |in Pytho|
|00000080| 6e 2e 0d 53 6f 6d 65 20 | 67 65 6e 65 72 61 6c 20 |n..Some |general |
|00000090| 72 75 6c 65 73 20 66 6f | 72 20 77 6f 72 6b 69 6e |rules fo|r workin|
|000000a0| 67 20 77 69 74 68 20 73 | 69 67 6e 61 6c 73 20 68 |g with s|ignals h|
|000000b0| 61 6e 64 6c 65 72 73 3a | 0d 0d 5c 62 65 67 69 6e |andlers:|..\begin|
|000000c0| 7b 69 74 65 6d 69 7a 65 | 7d 0d 0d 5c 69 74 65 6d |{itemize|}..\item|
|000000d0| 0d 41 20 68 61 6e 64 6c | 65 72 20 66 6f 72 20 61 |.A handl|er for a|
|000000e0| 20 70 61 72 74 69 63 75 | 6c 61 72 20 73 69 67 6e | particu|lar sign|
|000000f0| 61 6c 2c 20 6f 6e 63 65 | 20 73 65 74 2c 20 72 65 |al, once| set, re|
|00000100| 6d 61 69 6e 73 20 69 6e | 73 74 61 6c 6c 65 64 20 |mains in|stalled |
|00000110| 75 6e 74 69 6c 0d 69 74 | 20 69 73 20 65 78 70 6c |until.it| is expl|
|00000120| 69 63 69 74 6c 79 20 72 | 65 73 65 74 20 28 69 2e |icitly r|eset (i.|
|00000130| 65 2e 20 50 79 74 68 6f | 6e 20 75 73 65 73 20 74 |e. Pytho|n uses t|
|00000140| 68 65 20 42 53 44 20 73 | 74 79 6c 65 20 69 6e 74 |he BSD s|tyle int|
|00000150| 65 72 66 61 63 65 29 2e | 0d 0d 5c 69 74 65 6d 0d |erface).|..\item.|
|00000160| 54 68 65 72 65 20 69 73 | 20 6e 6f 20 77 61 79 20 |There is| no way |
|00000170| 74 6f 20 60 60 62 6c 6f | 63 6b 27 27 20 73 69 67 |to ``blo|ck'' sig|
|00000180| 6e 61 6c 73 20 74 65 6d | 70 6f 72 61 72 69 6c 79 |nals tem|porarily|
|00000190| 20 66 72 6f 6d 20 63 72 | 69 74 69 63 61 6c 0d 73 | from cr|itical.s|
|000001a0| 65 63 74 69 6f 6e 73 20 | 28 73 69 6e 63 65 20 74 |ections |(since t|
|000001b0| 68 69 73 20 69 73 20 6e | 6f 74 20 73 75 70 70 6f |his is n|ot suppo|
|000001c0| 72 74 65 64 20 62 79 20 | 61 6c 6c 20 5c 55 4e 49 |rted by |all \UNI|
|000001d0| 58 7b 7d 20 66 6c 61 76 | 6f 72 73 29 2e 0d 0d 5c |X{} flav|ors)...\|
|000001e0| 69 74 65 6d 0d 41 6c 74 | 68 6f 75 67 68 20 50 79 |item.Alt|hough Py|
|000001f0| 74 68 6f 6e 20 73 69 67 | 6e 61 6c 20 68 61 6e 64 |thon sig|nal hand|
|00000200| 6c 65 72 73 20 61 72 65 | 20 63 61 6c 6c 65 64 20 |lers are| called |
|00000210| 61 73 79 6e 63 68 72 6f | 6e 6f 75 73 6c 79 20 61 |asynchro|nously a|
|00000220| 73 20 66 61 72 20 61 73 | 0d 74 68 65 20 50 79 74 |s far as|.the Pyt|
|00000230| 68 6f 6e 20 75 73 65 72 | 20 69 73 20 63 6f 6e 63 |hon user| is conc|
|00000240| 65 72 6e 65 64 2c 20 74 | 68 65 79 20 63 61 6e 20 |erned, t|hey can |
|00000250| 6f 6e 6c 79 20 6f 63 63 | 75 72 20 62 65 74 77 65 |only occ|ur betwe|
|00000260| 65 6e 20 74 68 65 0d 60 | 60 61 74 6f 6d 69 63 27 |en the.`|`atomic'|
|00000270| 27 20 69 6e 73 74 72 75 | 63 74 69 6f 6e 73 20 6f |' instru|ctions o|
|00000280| 66 20 74 68 65 20 50 79 | 74 68 6f 6e 20 69 6e 74 |f the Py|thon int|
|00000290| 65 72 70 72 65 74 65 72 | 2e 20 20 54 68 69 73 20 |erpreter|. This |
|000002a0| 6d 65 61 6e 73 20 74 68 | 61 74 0d 73 69 67 6e 61 |means th|at.signa|
|000002b0| 6c 73 20 61 72 72 69 76 | 69 6e 67 20 64 75 72 69 |ls arriv|ing duri|
|000002c0| 6e 67 20 6c 6f 6e 67 20 | 63 61 6c 63 75 6c 61 74 |ng long |calculat|
|000002d0| 69 6f 6e 73 20 69 6d 70 | 6c 65 6d 65 6e 74 65 64 |ions imp|lemented|
|000002e0| 20 70 75 72 65 6c 79 20 | 69 6e 20 43 0d 28 65 2e | purely |in C.(e.|
|000002f0| 67 2e 5c 20 72 65 67 75 | 6c 61 72 20 65 78 70 72 |g.\ regu|lar expr|
|00000300| 65 73 73 69 6f 6e 20 6d | 61 74 63 68 65 73 20 6f |ession m|atches o|
|00000310| 6e 20 6c 61 72 67 65 20 | 62 6f 64 69 65 73 20 6f |n large |bodies o|
|00000320| 66 20 74 65 78 74 29 20 | 6d 61 79 20 62 65 0d 64 |f text) |may be.d|
|00000330| 65 6c 61 79 65 64 20 66 | 6f 72 20 61 6e 20 61 72 |elayed f|or an ar|
|00000340| 62 69 74 72 61 72 79 20 | 61 6d 6f 75 6e 74 20 6f |bitrary |amount o|
|00000350| 66 20 74 69 6d 65 2e 0d | 0d 5c 69 74 65 6d 0d 57 |f time..|.\item.W|
|00000360| 68 65 6e 20 61 20 73 69 | 67 6e 61 6c 20 61 72 72 |hen a si|gnal arr|
|00000370| 69 76 65 73 20 64 75 72 | 69 6e 67 20 61 6e 20 49 |ives dur|ing an I|
|00000380| 2f 4f 20 6f 70 65 72 61 | 74 69 6f 6e 2c 20 69 74 |/O opera|tion, it|
|00000390| 20 69 73 20 70 6f 73 73 | 69 62 6c 65 20 74 68 61 | is poss|ible tha|
|000003a0| 74 20 74 68 65 0d 49 2f | 4f 20 6f 70 65 72 61 74 |t the.I/|O operat|
|000003b0| 69 6f 6e 20 72 61 69 73 | 65 73 20 61 6e 20 65 78 |ion rais|es an ex|
|000003c0| 63 65 70 74 69 6f 6e 20 | 61 66 74 65 72 20 74 68 |ception |after th|
|000003d0| 65 20 73 69 67 6e 61 6c | 20 68 61 6e 64 6c 65 72 |e signal| handler|
|000003e0| 20 72 65 74 75 72 6e 73 | 2e 0d 54 68 69 73 20 69 | returns|..This i|
|000003f0| 73 20 64 65 70 65 6e 64 | 65 6e 74 20 6f 6e 20 74 |s depend|ent on t|
|00000400| 68 65 20 75 6e 64 65 72 | 6c 79 69 6e 67 20 5c 55 |he under|lying \U|
|00000410| 4e 49 58 7b 7d 20 73 79 | 73 74 65 6d 27 73 20 73 |NIX{} sy|stem's s|
|00000420| 65 6d 61 6e 74 69 63 73 | 20 72 65 67 61 72 64 69 |emantics| regardi|
|00000430| 6e 67 0d 69 6e 74 65 72 | 72 75 70 74 65 64 20 73 |ng.inter|rupted s|
|00000440| 79 73 74 65 6d 20 63 61 | 6c 6c 73 2e 0d 0d 5c 69 |ystem ca|lls...\i|
|00000450| 74 65 6d 0d 42 65 63 61 | 75 73 65 20 74 68 65 20 |tem.Beca|use the |
|00000460| 43 20 73 69 67 6e 61 6c | 20 68 61 6e 64 6c 65 72 |C signal| handler|
|00000470| 20 61 6c 77 61 79 73 20 | 72 65 74 75 72 6e 73 2c | always |returns,|
|00000480| 20 69 74 20 6d 61 6b 65 | 73 20 6c 69 74 74 6c 65 | it make|s little|
|00000490| 20 73 65 6e 73 65 20 74 | 6f 0d 63 61 74 63 68 20 | sense t|o.catch |
|000004a0| 73 79 6e 63 68 72 6f 6e | 6f 75 73 20 65 72 72 6f |synchron|ous erro|
|000004b0| 72 73 20 6c 69 6b 65 20 | 5c 63 6f 64 65 7b 53 49 |rs like |\code{SI|
|000004c0| 47 46 50 45 7d 20 6f 72 | 20 5c 63 6f 64 65 7b 53 |GFPE} or| \code{S|
|000004d0| 49 47 53 45 47 56 7d 2e | 0d 0d 5c 69 74 65 6d 0d |IGSEGV}.|..\item.|
|000004e0| 50 79 74 68 6f 6e 20 69 | 6e 73 74 61 6c 6c 73 20 |Python i|nstalls |
|000004f0| 61 20 73 6d 61 6c 6c 20 | 6e 75 6d 62 65 72 20 6f |a small |number o|
|00000500| 66 20 73 69 67 6e 61 6c | 20 68 61 6e 64 6c 65 72 |f signal| handler|
|00000510| 73 20 62 79 20 64 65 66 | 61 75 6c 74 3a 0d 5c 63 |s by def|ault:.\c|
|00000520| 6f 64 65 7b 53 49 47 50 | 49 50 45 7d 20 69 73 20 |ode{SIGP|IPE} is |
|00000530| 69 67 6e 6f 72 65 64 20 | 28 73 6f 20 77 72 69 74 |ignored |(so writ|
|00000540| 65 20 65 72 72 6f 72 73 | 20 6f 6e 20 70 69 70 65 |e errors| on pipe|
|00000550| 73 20 61 6e 64 20 73 6f | 63 6b 65 74 73 20 63 61 |s and so|ckets ca|
|00000560| 6e 20 62 65 0d 72 65 70 | 6f 72 74 65 64 20 61 73 |n be.rep|orted as|
|00000570| 20 6f 72 64 69 6e 61 72 | 79 20 50 79 74 68 6f 6e | ordinar|y Python|
|00000580| 20 65 78 63 65 70 74 69 | 6f 6e 73 29 2c 20 5c 63 | excepti|ons), \c|
|00000590| 6f 64 65 7b 53 49 47 49 | 4e 54 7d 20 69 73 20 74 |ode{SIGI|NT} is t|
|000005a0| 72 61 6e 73 6c 61 74 65 | 64 0d 69 6e 74 6f 20 61 |ranslate|d.into a|
|000005b0| 20 5c 63 6f 64 65 7b 4b | 65 79 62 6f 61 72 64 49 | \code{K|eyboardI|
|000005c0| 6e 74 65 72 72 75 70 74 | 7d 20 65 78 63 65 70 74 |nterrupt|} except|
|000005d0| 69 6f 6e 2c 20 61 6e 64 | 20 5c 63 6f 64 65 7b 53 |ion, and| \code{S|
|000005e0| 49 47 54 45 52 4d 7d 20 | 69 73 0d 63 61 75 67 68 |IGTERM} |is.caugh|
|000005f0| 74 20 73 6f 20 74 68 61 | 74 20 6e 65 63 65 73 73 |t so tha|t necess|
|00000600| 61 72 79 20 63 6c 65 61 | 6e 75 70 20 28 65 73 70 |ary clea|nup (esp|
|00000610| 65 63 69 61 6c 6c 79 20 | 5c 63 6f 64 65 7b 73 79 |ecially |\code{sy|
|00000620| 73 2e 65 78 69 74 66 75 | 6e 63 7d 29 20 63 61 6e |s.exitfu|nc}) can|
|00000630| 0d 62 65 20 70 65 72 66 | 6f 72 6d 65 64 20 62 65 |.be perf|ormed be|
|00000640| 66 6f 72 65 20 61 63 74 | 75 61 6c 6c 79 20 74 65 |fore act|ually te|
|00000650| 72 6d 69 6e 61 74 69 6e | 67 2e 20 20 41 6c 6c 20 |rminatin|g. All |
|00000660| 6f 66 20 74 68 65 73 65 | 20 63 61 6e 20 62 65 0d |of these| can be.|
|00000670| 6f 76 65 72 72 69 64 64 | 65 6e 2e 0d 0d 5c 69 74 |overridd|en...\it|
|00000680| 65 6d 0d 53 6f 6d 65 20 | 63 61 72 65 20 6d 75 73 |em.Some |care mus|
|00000690| 74 20 62 65 20 74 61 6b | 65 6e 20 69 66 20 62 6f |t be tak|en if bo|
|000006a0| 74 68 20 73 69 67 6e 61 | 6c 73 20 61 6e 64 20 74 |th signa|ls and t|
|000006b0| 68 72 65 61 64 73 20 61 | 72 65 20 75 73 65 64 20 |hreads a|re used |
|000006c0| 69 6e 20 74 68 65 0d 73 | 61 6d 65 20 70 72 6f 67 |in the.s|ame prog|
|000006d0| 72 61 6d 2e 20 20 54 68 | 65 20 66 75 6e 64 61 6d |ram. Th|e fundam|
|000006e0| 65 6e 74 61 6c 20 74 68 | 69 6e 67 20 74 6f 20 72 |ental th|ing to r|
|000006f0| 65 6d 65 6d 62 65 72 20 | 69 6e 20 75 73 69 6e 67 |emember |in using|
|00000700| 20 73 69 67 6e 61 6c 73 | 20 61 6e 64 0d 74 68 72 | signals| and.thr|
|00000710| 65 61 64 73 20 73 69 6d | 75 6c 74 61 6e 65 6f 75 |eads sim|ultaneou|
|00000720| 73 6c 79 20 69 73 3a 5c | 20 61 6c 77 61 79 73 20 |sly is:\| always |
|00000730| 70 65 72 66 6f 72 6d 20 | 5c 63 6f 64 65 7b 73 69 |perform |\code{si|
|00000740| 67 6e 61 6c 28 29 7d 20 | 6f 70 65 72 61 74 69 6f |gnal()} |operatio|
|00000750| 6e 73 0d 69 6e 20 74 68 | 65 20 6d 61 69 6e 20 74 |ns.in th|e main t|
|00000760| 68 72 65 61 64 20 6f 66 | 20 65 78 65 63 75 74 69 |hread of| executi|
|00000770| 6f 6e 2e 20 20 41 6e 79 | 20 74 68 72 65 61 64 20 |on. Any| thread |
|00000780| 63 61 6e 20 70 65 72 66 | 6f 72 6d 20 61 6e 0d 5c |can perf|orm an.\|
|00000790| 63 6f 64 65 7b 61 6c 61 | 72 6d 28 29 7d 2c 20 5c |code{ala|rm()}, \|
|000007a0| 63 6f 64 65 7b 67 65 74 | 73 69 67 6e 61 6c 28 29 |code{get|signal()|
|000007b0| 7d 2c 20 6f 72 20 5c 63 | 6f 64 65 7b 70 61 75 73 |}, or \c|ode{paus|
|000007c0| 65 28 29 7d 3b 20 6f 6e | 6c 79 20 74 68 65 20 6d |e()}; on|ly the m|
|000007d0| 61 69 6e 0d 74 68 72 65 | 61 64 20 63 61 6e 20 73 |ain.thre|ad can s|
|000007e0| 65 74 20 61 20 6e 65 77 | 20 73 69 67 6e 61 6c 20 |et a new| signal |
|000007f0| 68 61 6e 64 6c 65 72 2c | 20 61 6e 64 20 74 68 65 |handler,| and the|
|00000800| 20 6d 61 69 6e 20 74 68 | 72 65 61 64 20 77 69 6c | main th|read wil|
|00000810| 6c 20 62 65 20 74 68 65 | 0d 6f 6e 6c 79 20 6f 6e |l be the|.only on|
|00000820| 65 20 74 6f 20 72 65 63 | 65 69 76 65 20 73 69 67 |e to rec|eive sig|
|00000830| 6e 61 6c 73 20 28 74 68 | 69 73 20 69 73 20 65 6e |nals (th|is is en|
|00000840| 66 6f 72 63 65 64 20 62 | 79 20 74 68 65 20 50 79 |forced b|y the Py|
|00000850| 74 68 6f 6e 20 73 69 67 | 6e 61 6c 0d 6d 6f 64 75 |thon sig|nal.modu|
|00000860| 6c 65 2c 20 65 76 65 6e | 20 69 66 20 74 68 65 20 |le, even| if the |
|00000870| 75 6e 64 65 72 6c 79 69 | 6e 67 20 74 68 72 65 61 |underlyi|ng threa|
|00000880| 64 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 69 6f 6e |d implem|entation|
|00000890| 20 73 75 70 70 6f 72 74 | 73 20 73 65 6e 64 69 6e | support|s sendin|
|000008a0| 67 0d 73 69 67 6e 61 6c | 73 20 74 6f 20 69 6e 64 |g.signal|s to ind|
|000008b0| 69 76 69 64 75 61 6c 20 | 74 68 72 65 61 64 73 29 |ividual |threads)|
|000008c0| 2e 20 20 54 68 69 73 20 | 6d 65 61 6e 73 20 74 68 |. This |means th|
|000008d0| 61 74 20 73 69 67 6e 61 | 6c 73 20 63 61 6e 27 74 |at signa|ls can't|
|000008e0| 20 62 65 20 75 73 65 64 | 0d 61 73 20 61 20 6d 65 | be used|.as a me|
|000008f0| 61 6e 73 20 6f 66 20 69 | 6e 74 65 72 74 68 72 65 |ans of i|nterthre|
|00000900| 61 64 20 63 6f 6d 6d 75 | 6e 69 63 61 74 69 6f 6e |ad commu|nication|
|00000910| 2e 20 20 55 73 65 20 6c | 6f 63 6b 73 20 69 6e 73 |. Use l|ocks ins|
|00000920| 74 65 61 64 2e 0d 0d 5c | 65 6e 64 7b 69 74 65 6d |tead...\|end{item|
|00000930| 69 7a 65 7d 0d 0d 54 68 | 65 20 76 61 72 69 61 62 |ize}..Th|e variab|
|00000940| 6c 65 73 20 64 65 66 69 | 6e 65 64 20 69 6e 20 74 |les defi|ned in t|
|00000950| 68 65 20 73 69 67 6e 61 | 6c 20 6d 6f 64 75 6c 65 |he signa|l module|
|00000960| 20 61 72 65 3a 0d 0d 5c | 72 65 6e 65 77 63 6f 6d | are:..\|renewcom|
|00000970| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000980| 65 6d 7d 7b 28 69 6e 20 | 6d 6f 64 75 6c 65 20 73 |em}{(in |module s|
|00000990| 69 67 6e 61 6c 29 7d 0d | 5c 62 65 67 69 6e 7b 64 |ignal)}.|\begin{d|
|000009a0| 61 74 61 64 65 73 63 7d | 7b 53 49 47 5f 44 46 4c |atadesc}|{SIG_DFL|
|000009b0| 7d 0d 20 20 54 68 69 73 | 20 69 73 20 6f 6e 65 20 |}. This| is one |
|000009c0| 6f 66 20 74 77 6f 20 73 | 74 61 6e 64 61 72 64 20 |of two s|tandard |
|000009d0| 73 69 67 6e 61 6c 20 68 | 61 6e 64 6c 69 6e 67 20 |signal h|andling |
|000009e0| 6f 70 74 69 6f 6e 73 3b | 20 69 74 20 77 69 6c 6c |options;| it will|
|000009f0| 20 73 69 6d 70 6c 79 0d | 20 20 70 65 72 66 6f 72 | simply.| perfor|
|00000a00| 6d 20 74 68 65 20 64 65 | 66 61 75 6c 74 20 66 75 |m the de|fault fu|
|00000a10| 6e 63 74 69 6f 6e 20 66 | 6f 72 20 74 68 65 20 73 |nction f|or the s|
|00000a20| 69 67 6e 61 6c 2e 20 20 | 46 6f 72 20 65 78 61 6d |ignal. |For exam|
|00000a30| 70 6c 65 2c 20 6f 6e 20 | 6d 6f 73 74 0d 20 20 73 |ple, on |most. s|
|00000a40| 79 73 74 65 6d 73 20 74 | 68 65 20 64 65 66 61 75 |ystems t|he defau|
|00000a50| 6c 74 20 61 63 74 69 6f | 6e 20 66 6f 72 20 53 49 |lt actio|n for SI|
|00000a60| 47 51 55 49 54 20 69 73 | 20 74 6f 20 64 75 6d 70 |GQUIT is| to dump|
|00000a70| 20 63 6f 72 65 20 61 6e | 64 20 65 78 69 74 2c 0d | core an|d exit,.|
|00000a80| 20 20 77 68 69 6c 65 20 | 74 68 65 20 64 65 66 61 | while |the defa|
|00000a90| 75 6c 74 20 61 63 74 69 | 6f 6e 20 66 6f 72 20 53 |ult acti|on for S|
|00000aa0| 49 47 43 4c 44 20 69 73 | 20 74 6f 20 73 69 6d 70 |IGCLD is| to simp|
|00000ab0| 6c 79 20 69 67 6e 6f 72 | 65 20 69 74 2e 0d 5c 65 |ly ignor|e it..\e|
|00000ac0| 6e 64 7b 64 61 74 61 64 | 65 73 63 7d 0d 0d 5c 62 |nd{datad|esc}..\b|
|00000ad0| 65 67 69 6e 7b 64 61 74 | 61 64 65 73 63 7d 7b 53 |egin{dat|adesc}{S|
|00000ae0| 49 47 5f 49 47 4e 7d 0d | 20 20 54 68 69 73 20 69 |IG_IGN}.| This i|
|00000af0| 73 20 61 6e 6f 74 68 65 | 72 20 73 74 61 6e 64 61 |s anothe|r standa|
|00000b00| 72 64 20 73 69 67 6e 61 | 6c 20 68 61 6e 64 6c 65 |rd signa|l handle|
|00000b10| 72 2c 20 77 68 69 63 68 | 20 77 69 6c 6c 20 73 69 |r, which| will si|
|00000b20| 6d 70 6c 79 20 69 67 6e | 6f 72 65 0d 20 20 74 68 |mply ign|ore. th|
|00000b30| 65 20 67 69 76 65 6e 20 | 73 69 67 6e 61 6c 2e 0d |e given |signal..|
|00000b40| 5c 65 6e 64 7b 64 61 74 | 61 64 65 73 63 7d 0d 0d |\end{dat|adesc}..|
|00000b50| 5c 62 65 67 69 6e 7b 64 | 61 74 61 64 65 73 63 7d |\begin{d|atadesc}|
|00000b60| 7b 53 49 47 2a 7d 0d 20 | 20 41 6c 6c 20 74 68 65 |{SIG*}. | All the|
|00000b70| 20 73 69 67 6e 61 6c 20 | 6e 75 6d 62 65 72 73 20 | signal |numbers |
|00000b80| 61 72 65 20 64 65 66 69 | 6e 65 64 20 73 79 6d 62 |are defi|ned symb|
|00000b90| 6f 6c 69 63 61 6c 6c 79 | 2e 20 20 46 6f 72 20 65 |olically|. For e|
|00000ba0| 78 61 6d 70 6c 65 2c 20 | 74 68 65 0d 20 20 68 61 |xample, |the. ha|
|00000bb0| 6e 67 75 70 20 73 69 67 | 6e 61 6c 20 69 73 20 64 |ngup sig|nal is d|
|00000bc0| 65 66 69 6e 65 64 20 61 | 73 20 5c 63 6f 64 65 7b |efined a|s \code{|
|00000bd0| 73 69 67 6e 61 6c 2e 53 | 49 47 48 55 50 7d 3b 20 |signal.S|IGHUP}; |
|00000be0| 74 68 65 20 76 61 72 69 | 61 62 6c 65 20 6e 61 6d |the vari|able nam|
|00000bf0| 65 73 0d 20 20 61 72 65 | 20 69 64 65 6e 74 69 63 |es. are| identic|
|00000c00| 61 6c 20 74 6f 20 74 68 | 65 20 6e 61 6d 65 73 20 |al to th|e names |
|00000c10| 75 73 65 64 20 69 6e 20 | 43 20 70 72 6f 67 72 61 |used in |C progra|
|00000c20| 6d 73 2c 20 61 73 20 66 | 6f 75 6e 64 20 69 6e 0d |ms, as f|ound in.|
|00000c30| 20 20 5c 66 69 6c 65 7b | 73 69 67 6e 61 6c 2e 68 | \file{|signal.h|
|00000c40| 7d 2e 0d 20 20 54 68 65 | 20 5c 55 4e 49 58 7b 7d |}.. The| \UNIX{}|
|00000c50| 20 6d 61 6e 20 70 61 67 | 65 20 66 6f 72 20 5c 66 | man pag|e for \f|
|00000c60| 69 6c 65 7b 73 69 67 6e | 61 6c 7d 20 6c 69 73 74 |ile{sign|al} list|
|00000c70| 73 20 74 68 65 20 65 78 | 69 73 74 69 6e 67 20 73 |s the ex|isting s|
|00000c80| 69 67 6e 61 6c 73 20 28 | 6f 6e 0d 20 20 73 6f 6d |ignals (|on. som|
|00000c90| 65 20 73 79 73 74 65 6d | 73 20 74 68 69 73 20 69 |e system|s this i|
|00000ca0| 73 20 5c 66 69 6c 65 7b | 73 69 67 6e 61 6c 28 32 |s \file{|signal(2|
|00000cb0| 29 7d 2c 20 6f 6e 20 6f | 74 68 65 72 73 20 74 68 |)}, on o|thers th|
|00000cc0| 65 20 6c 69 73 74 20 69 | 73 20 69 6e 0d 20 20 5c |e list i|s in. \|
|00000cd0| 66 69 6c 65 7b 73 69 67 | 6e 61 6c 28 37 29 7d 29 |file{sig|nal(7)})|
|00000ce0| 2e 0d 20 20 4e 6f 74 65 | 20 74 68 61 74 20 6e 6f |.. Note| that no|
|00000cf0| 74 20 61 6c 6c 20 73 79 | 73 74 65 6d 73 20 64 65 |t all sy|stems de|
|00000d00| 66 69 6e 65 20 74 68 65 | 20 73 61 6d 65 20 73 65 |fine the| same se|
|00000d10| 74 20 6f 66 20 73 69 67 | 6e 61 6c 20 6e 61 6d 65 |t of sig|nal name|
|00000d20| 73 3b 20 6f 6e 6c 79 0d | 20 20 74 68 6f 73 65 20 |s; only.| those |
|00000d30| 6e 61 6d 65 73 20 64 65 | 66 69 6e 65 64 20 62 79 |names de|fined by|
|00000d40| 20 74 68 65 20 73 79 73 | 74 65 6d 20 61 72 65 20 | the sys|tem are |
|00000d50| 64 65 66 69 6e 65 64 20 | 62 79 20 74 68 69 73 20 |defined |by this |
|00000d60| 6d 6f 64 75 6c 65 2e 0d | 5c 65 6e 64 7b 64 61 74 |module..|\end{dat|
|00000d70| 61 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 64 |adesc}..|\begin{d|
|00000d80| 61 74 61 64 65 73 63 7d | 7b 4e 53 49 47 7d 0d 20 |atadesc}|{NSIG}. |
|00000d90| 20 4f 6e 65 20 6d 6f 72 | 65 20 74 68 61 6e 20 74 | One mor|e than t|
|00000da0| 68 65 20 6e 75 6d 62 65 | 72 20 6f 66 20 74 68 65 |he numbe|r of the|
|00000db0| 20 68 69 67 68 65 73 74 | 20 73 69 67 6e 61 6c 20 | highest| signal |
|00000dc0| 6e 75 6d 62 65 72 2e 0d | 5c 65 6e 64 7b 64 61 74 |number..|\end{dat|
|00000dd0| 61 64 65 73 63 7d 0d 0d | 54 68 65 20 73 69 67 6e |adesc}..|The sign|
|00000de0| 61 6c 20 6d 6f 64 75 6c | 65 20 64 65 66 69 6e 65 |al modul|e define|
|00000df0| 73 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |s the fo|llowing |
|00000e00| 66 75 6e 63 74 69 6f 6e | 73 3a 0d 0d 5c 62 65 67 |function|s:..\beg|
|00000e10| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 61 6c 61 |in{funcd|esc}{ala|
|00000e20| 72 6d 7d 7b 74 69 6d 65 | 7d 0d 20 20 49 66 20 5c |rm}{time|}. If \|
|00000e30| 76 61 72 7b 74 69 6d 65 | 7d 20 69 73 20 6e 6f 6e |var{time|} is non|
|00000e40| 2d 7a 65 72 6f 2c 20 74 | 68 69 73 20 66 75 6e 63 |-zero, t|his func|
|00000e50| 74 69 6f 6e 20 72 65 71 | 75 65 73 74 73 20 74 68 |tion req|uests th|
|00000e60| 61 74 20 61 0d 20 20 5c | 63 6f 64 65 7b 53 49 47 |at a. \|code{SIG|
|00000e70| 41 4c 52 4d 7d 20 73 69 | 67 6e 61 6c 20 62 65 20 |ALRM} si|gnal be |
|00000e80| 73 65 6e 74 20 74 6f 20 | 74 68 65 20 70 72 6f 63 |sent to |the proc|
|00000e90| 65 73 73 20 69 6e 20 5c | 76 61 72 7b 74 69 6d 65 |ess in \|var{time|
|00000ea0| 7d 20 73 65 63 6f 6e 64 | 73 2e 0d 20 20 41 6e 79 |} second|s.. Any|
|00000eb0| 20 70 72 65 76 69 6f 75 | 73 6c 79 20 73 63 68 65 | previou|sly sche|
|00000ec0| 64 75 6c 65 64 20 61 6c | 61 72 6d 20 69 73 20 63 |duled al|arm is c|
|00000ed0| 61 6e 63 65 6c 65 64 20 | 28 69 2e 65 2e 5c 20 6f |anceled |(i.e.\ o|
|00000ee0| 6e 6c 79 20 6f 6e 65 20 | 61 6c 61 72 6d 20 63 61 |nly one |alarm ca|
|00000ef0| 6e 0d 20 20 62 65 20 73 | 63 68 65 64 75 6c 65 64 |n. be s|cheduled|
|00000f00| 20 61 74 20 61 6e 79 20 | 74 69 6d 65 29 2e 20 20 | at any |time). |
|00000f10| 54 68 65 20 72 65 74 75 | 72 6e 65 64 20 76 61 6c |The retu|rned val|
|00000f20| 75 65 20 69 73 20 74 68 | 65 6e 20 74 68 65 20 6e |ue is th|en the n|
|00000f30| 75 6d 62 65 72 20 6f 66 | 0d 20 20 73 65 63 6f 6e |umber of|. secon|
|00000f40| 64 73 20 62 65 66 6f 72 | 65 20 61 6e 79 20 70 72 |ds befor|e any pr|
|00000f50| 65 76 69 6f 75 73 6c 79 | 20 73 65 74 20 61 6c 61 |eviously| set ala|
|00000f60| 72 6d 20 77 61 73 20 74 | 6f 20 68 61 76 65 20 62 |rm was t|o have b|
|00000f70| 65 65 6e 20 64 65 6c 69 | 76 65 72 65 64 2e 0d 20 |een deli|vered.. |
|00000f80| 20 49 66 20 5c 76 61 72 | 7b 74 69 6d 65 7d 20 69 | If \var|{time} i|
|00000f90| 73 20 7a 65 72 6f 2c 20 | 6e 6f 20 61 6c 61 72 6d |s zero, |no alarm|
|00000fa0| 20 69 64 20 73 63 68 65 | 64 75 6c 65 64 2c 20 61 | id sche|duled, a|
|00000fb0| 6e 64 20 61 6e 79 20 73 | 63 68 65 64 75 6c 65 64 |nd any s|cheduled|
|00000fc0| 0d 20 20 61 6c 61 72 6d | 20 69 73 20 63 61 6e 63 |. alarm| is canc|
|00000fd0| 65 6c 65 64 2e 20 20 54 | 68 65 20 72 65 74 75 72 |eled. T|he retur|
|00000fe0| 6e 20 76 61 6c 75 65 20 | 69 73 20 74 68 65 20 6e |n value |is the n|
|00000ff0| 75 6d 62 65 72 20 6f 66 | 20 73 65 63 6f 6e 64 73 |umber of| seconds|
|00001000| 0d 20 20 72 65 6d 61 69 | 6e 69 6e 67 20 62 65 66 |. remai|ning bef|
|00001010| 6f 72 65 20 61 20 70 72 | 65 76 69 6f 75 73 6c 79 |ore a pr|eviously|
|00001020| 20 73 63 68 65 64 75 6c | 65 64 20 61 6c 61 72 6d | schedul|ed alarm|
|00001030| 2e 20 20 49 66 20 74 68 | 65 20 72 65 74 75 72 6e |. If th|e return|
|00001040| 20 76 61 6c 75 65 0d 20 | 20 69 73 20 7a 65 72 6f | value. | is zero|
|00001050| 2c 20 6e 6f 20 61 6c 61 | 72 6d 20 69 73 20 63 75 |, no ala|rm is cu|
|00001060| 72 72 65 6e 74 6c 79 20 | 73 63 68 65 64 75 6c 65 |rrently |schedule|
|00001070| 64 2e 20 20 28 53 65 65 | 20 74 68 65 20 5c 55 4e |d. (See| the \UN|
|00001080| 49 58 7b 7d 20 6d 61 6e | 20 70 61 67 65 0d 20 20 |IX{} man| page. |
|00001090| 5c 63 6f 64 65 7b 61 6c | 61 72 6d 28 32 29 7d 2e |\code{al|arm(2)}.|
|000010a0| 29 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|000010b0| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000010c0| 63 7d 7b 67 65 74 73 69 | 67 6e 61 6c 7d 7b 73 69 |c}{getsi|gnal}{si|
|000010d0| 67 6e 61 6c 6e 75 6d 7d | 0d 20 20 52 65 74 75 72 |gnalnum}|. Retur|
|000010e0| 6e 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 73 69 |n the cu|rrent si|
|000010f0| 67 6e 61 6c 20 68 61 6e | 64 6c 65 72 20 66 6f 72 |gnal han|dler for|
|00001100| 20 74 68 65 20 73 69 67 | 6e 61 6c 20 5c 76 61 72 | the sig|nal \var|
|00001110| 7b 73 69 67 6e 61 6c 6e | 75 6d 7d 2e 0d 20 20 54 |{signaln|um}.. T|
|00001120| 68 65 20 72 65 74 75 72 | 6e 65 64 20 76 61 6c 75 |he retur|ned valu|
|00001130| 65 20 6d 61 79 20 62 65 | 20 61 20 63 61 6c 6c 61 |e may be| a calla|
|00001140| 62 6c 65 20 50 79 74 68 | 6f 6e 20 6f 62 6a 65 63 |ble Pyth|on objec|
|00001150| 74 2c 20 6f 72 20 6f 6e | 65 20 6f 66 20 74 68 65 |t, or on|e of the|
|00001160| 0d 20 20 73 70 65 63 69 | 61 6c 20 76 61 6c 75 65 |. speci|al value|
|00001170| 73 20 5c 63 6f 64 65 7b | 73 69 67 6e 61 6c 2e 53 |s \code{|signal.S|
|00001180| 49 47 5f 49 47 4e 7d 2c | 20 5c 63 6f 64 65 7b 73 |IG_IGN},| \code{s|
|00001190| 69 67 6e 61 6c 2e 53 49 | 47 5f 44 46 4c 7d 20 6f |ignal.SI|G_DFL} o|
|000011a0| 72 0d 20 20 5c 63 6f 64 | 65 7b 4e 6f 6e 65 7d 2e |r. \cod|e{None}.|
|000011b0| 20 20 48 65 72 65 2c 20 | 5c 63 6f 64 65 7b 73 69 | Here, |\code{si|
|000011c0| 67 6e 61 6c 2e 53 49 47 | 5f 49 47 4e 7d 20 6d 65 |gnal.SIG|_IGN} me|
|000011d0| 61 6e 73 20 74 68 61 74 | 20 74 68 65 20 73 69 67 |ans that| the sig|
|000011e0| 6e 61 6c 20 77 61 73 0d | 20 20 70 72 65 76 69 6f |nal was.| previo|
|000011f0| 75 73 6c 79 20 69 67 6e | 6f 72 65 64 2c 20 5c 63 |usly ign|ored, \c|
|00001200| 6f 64 65 7b 73 69 67 6e | 61 6c 2e 53 49 47 5f 44 |ode{sign|al.SIG_D|
|00001210| 46 4c 7d 20 6d 65 61 6e | 73 20 74 68 61 74 20 74 |FL} mean|s that t|
|00001220| 68 65 20 64 65 66 61 75 | 6c 74 20 77 61 79 0d 20 |he defau|lt way. |
|00001230| 20 6f 66 20 68 61 6e 64 | 6c 69 6e 67 20 74 68 65 | of hand|ling the|
|00001240| 20 73 69 67 6e 61 6c 20 | 77 61 73 20 70 72 65 76 | signal |was prev|
|00001250| 69 6f 75 73 6c 79 20 69 | 6e 20 75 73 65 2c 20 61 |iously i|n use, a|
|00001260| 6e 64 20 5c 63 6f 64 65 | 7b 4e 6f 6e 65 7d 20 6d |nd \code|{None} m|
|00001270| 65 61 6e 73 0d 20 20 74 | 68 61 74 20 74 68 65 20 |eans. t|hat the |
|00001280| 70 72 65 76 69 6f 75 73 | 20 73 69 67 6e 61 6c 20 |previous| signal |
|00001290| 68 61 6e 64 6c 65 72 20 | 77 61 73 20 6e 6f 74 20 |handler |was not |
|000012a0| 69 6e 73 74 61 6c 6c 65 | 64 20 66 72 6f 6d 20 50 |installe|d from P|
|000012b0| 79 74 68 6f 6e 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |ython..\|end{func|
|000012c0| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|000012d0| 6e 63 64 65 73 63 7d 7b | 70 61 75 73 65 7d 7b 7d |ncdesc}{|pause}{}|
|000012e0| 0d 20 20 43 61 75 73 65 | 20 74 68 65 20 70 72 6f |. Cause| the pro|
|000012f0| 63 65 73 73 20 74 6f 20 | 73 6c 65 65 70 20 75 6e |cess to |sleep un|
|00001300| 74 69 6c 20 61 20 73 69 | 67 6e 61 6c 20 69 73 20 |til a si|gnal is |
|00001310| 72 65 63 65 69 76 65 64 | 3b 20 74 68 65 0d 20 20 |received|; the. |
|00001320| 61 70 70 72 6f 70 72 69 | 61 74 65 20 68 61 6e 64 |appropri|ate hand|
|00001330| 6c 65 72 20 77 69 6c 6c | 20 74 68 65 6e 20 62 65 |ler will| then be|
|00001340| 20 63 61 6c 6c 65 64 2e | 20 20 52 65 74 75 72 6e | called.| Return|
|00001350| 73 20 6e 6f 74 68 69 6e | 67 2e 20 20 28 53 65 65 |s nothin|g. (See|
|00001360| 20 74 68 65 0d 20 20 5c | 55 4e 49 58 7b 7d 20 6d | the. \|UNIX{} m|
|00001370| 61 6e 20 70 61 67 65 20 | 5c 63 6f 64 65 7b 73 69 |an page |\code{si|
|00001380| 67 6e 61 6c 28 32 29 7d | 2e 29 0d 5c 65 6e 64 7b |gnal(2)}|.).\end{|
|00001390| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|000013a0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 73 69 67 6e |n{funcde|sc}{sign|
|000013b0| 61 6c 7d 7b 73 69 67 6e | 61 6c 6e 75 6d 5c 2c 20 |al}{sign|alnum\, |
|000013c0| 68 61 6e 64 6c 65 72 7d | 0d 20 20 53 65 74 20 74 |handler}|. Set t|
|000013d0| 68 65 20 68 61 6e 64 6c | 65 72 20 66 6f 72 20 73 |he handl|er for s|
|000013e0| 69 67 6e 61 6c 20 5c 76 | 61 72 7b 73 69 67 6e 61 |ignal \v|ar{signa|
|000013f0| 6c 6e 75 6d 7d 20 74 6f | 20 74 68 65 20 66 75 6e |lnum} to| the fun|
|00001400| 63 74 69 6f 6e 0d 20 20 | 5c 76 61 72 7b 68 61 6e |ction. |\var{han|
|00001410| 64 6c 65 72 7d 2e 20 20 | 5c 76 61 72 7b 68 61 6e |dler}. |\var{han|
|00001420| 64 6c 65 72 7d 20 63 61 | 6e 20 62 65 20 61 6e 79 |dler} ca|n be any|
|00001430| 20 63 61 6c 6c 61 62 6c | 65 20 50 79 74 68 6f 6e | callabl|e Python|
|00001440| 20 6f 62 6a 65 63 74 2c | 20 6f 72 0d 20 20 6f 6e | object,| or. on|
|00001450| 65 20 6f 66 20 74 68 65 | 20 73 70 65 63 69 61 6c |e of the| special|
|00001460| 20 76 61 6c 75 65 73 20 | 5c 63 6f 64 65 7b 73 69 | values |\code{si|
|00001470| 67 6e 61 6c 2e 53 49 47 | 5f 49 47 4e 7d 20 6f 72 |gnal.SIG|_IGN} or|
|00001480| 0d 20 20 5c 63 6f 64 65 | 7b 73 69 67 6e 61 6c 2e |. \code|{signal.|
|00001490| 53 49 47 5f 44 46 4c 7d | 2e 20 20 54 68 65 20 70 |SIG_DFL}|. The p|
|000014a0| 72 65 76 69 6f 75 73 20 | 73 69 67 6e 61 6c 20 68 |revious |signal h|
|000014b0| 61 6e 64 6c 65 72 20 77 | 69 6c 6c 20 62 65 20 72 |andler w|ill be r|
|000014c0| 65 74 75 72 6e 65 64 0d | 20 20 28 73 65 65 20 74 |eturned.| (see t|
|000014d0| 68 65 20 64 65 73 63 72 | 69 70 74 69 6f 6e 20 6f |he descr|iption o|
|000014e0| 66 20 5c 63 6f 64 65 7b | 67 65 74 73 69 67 6e 61 |f \code{|getsigna|
|000014f0| 6c 28 29 7d 20 61 62 6f | 76 65 29 2e 20 20 28 53 |l()} abo|ve). (S|
|00001500| 65 65 20 74 68 65 20 5c | 55 4e 49 58 7b 7d 0d 20 |ee the \|UNIX{}. |
|00001510| 20 6d 61 6e 20 70 61 67 | 65 20 5c 63 6f 64 65 7b | man pag|e \code{|
|00001520| 73 69 67 6e 61 6c 28 32 | 29 7d 2e 29 0d 0d 20 20 |signal(2|)}.).. |
|00001530| 57 68 65 6e 20 74 68 72 | 65 61 64 73 20 61 72 65 |When thr|eads are|
|00001540| 20 65 6e 61 62 6c 65 64 | 2c 20 74 68 69 73 20 66 | enabled|, this f|
|00001550| 75 6e 63 74 69 6f 6e 20 | 63 61 6e 20 6f 6e 6c 79 |unction |can only|
|00001560| 20 62 65 20 63 61 6c 6c | 65 64 20 66 72 6f 6d 20 | be call|ed from |
|00001570| 74 68 65 0d 20 20 6d 61 | 69 6e 20 74 68 72 65 61 |the. ma|in threa|
|00001580| 64 3b 20 61 74 74 65 6d | 70 74 69 6e 67 20 74 6f |d; attem|pting to|
|00001590| 20 63 61 6c 6c 20 69 74 | 20 66 72 6f 6d 20 6f 74 | call it| from ot|
|000015a0| 68 65 72 20 74 68 72 65 | 61 64 73 20 77 69 6c 6c |her thre|ads will|
|000015b0| 20 63 61 75 73 65 20 61 | 0d 20 20 5c 63 6f 64 65 | cause a|. \code|
|000015c0| 7b 56 61 6c 75 65 45 72 | 72 6f 72 7d 20 65 78 63 |{ValueEr|ror} exc|
|000015d0| 65 70 74 69 6f 6e 20 74 | 6f 20 62 65 20 72 61 69 |eption t|o be rai|
|000015e0| 73 65 64 2e 0d 0d 20 20 | 54 68 65 20 5c 76 61 72 |sed... |The \var|
|000015f0| 7b 68 61 6e 64 6c 65 72 | 7d 20 69 73 20 63 61 6c |{handler|} is cal|
|00001600| 6c 65 64 20 77 69 74 68 | 20 74 77 6f 20 61 72 67 |led with| two arg|
|00001610| 75 6d 65 6e 74 73 3a 20 | 74 68 65 20 73 69 67 6e |uments: |the sign|
|00001620| 61 6c 20 6e 75 6d 62 65 | 72 0d 20 20 61 6e 64 20 |al numbe|r. and |
|00001630| 74 68 65 20 63 75 72 72 | 65 6e 74 20 73 74 61 63 |the curr|ent stac|
|00001640| 6b 20 66 72 61 6d 65 20 | 28 5c 63 6f 64 65 7b 4e |k frame |(\code{N|
|00001650| 6f 6e 65 7d 20 6f 72 20 | 61 20 66 72 61 6d 65 20 |one} or |a frame |
|00001660| 6f 62 6a 65 63 74 3b 20 | 73 65 65 20 74 68 65 0d |object; |see the.|
|00001670| 20 20 72 65 66 65 72 65 | 6e 63 65 20 6d 61 6e 75 | refere|nce manu|
|00001680| 61 6c 20 66 6f 72 20 61 | 20 64 65 73 63 72 69 70 |al for a| descrip|
|00001690| 74 69 6f 6e 20 6f 66 20 | 66 72 61 6d 65 20 6f 62 |tion of |frame ob|
|000016a0| 6a 65 63 74 73 29 2e 0d | 5c 6f 62 69 6e 64 65 78 |jects)..|\obindex|
|000016b0| 7b 66 72 61 6d 65 7d 0d | 5c 65 6e 64 7b 66 75 6e |{frame}.|\end{fun|
|000016c0| 63 64 65 73 63 7d 0d | |cdesc}. | |
+--------+-------------------------+-------------------------+--------+--------+
